From 8032c48344af416a2b15e6c6c50816ddc4f8b6cf Mon Sep 17 00:00:00 2001
From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Sat, 29 Nov 2008 06:57:55 +0000
Subject: [PATCH] Improve deprecation annotations

svn path=/trunk/; revision=21815
---
 docs/reference/ChangeLog             | 13 +++++++++++++
 docs/reference/gtk/tmpl/gtkbbox.sgml | 26 +++++++++++++++++---------
 2 files changed, 30 insertions(+), 9 deletions(-)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 8622a34d94..d4bac676f7 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,16 @@
+2008-11-29  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkbbox.sgml: Improve deprecation annotations.
+
+2008-11-21  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/Makefile.am:
+	* gdk/Makefile.am:
+	* gdk-pixbuf/Makefile.am: Use a new gtk-doc feature to generate
+	much nicer indices.
+
+	* gtk/drawing-model.xml: Fix document structure
+
 2008-11-25  Christian Dywan  <christian@imendio.com>
 
 	Bug 559009 – gtk_radio_button_get_group documentation needs
diff --git a/docs/reference/gtk/tmpl/gtkbbox.sgml b/docs/reference/gtk/tmpl/gtkbbox.sgml
index 53dcbb99af..ae4b411a61 100644
--- a/docs/reference/gtk/tmpl/gtkbbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkbbox.sgml
@@ -100,7 +100,8 @@ Retrieves how much space a button box is placing between each child button.
 </para>
 
 @b: a #GtkButtonBox
-@Returns: the current spacing applied to the buttons in @widget.
+@Returns: the current spacing applied to the buttons in @widget
+@Deprecated: Use gtk_box_get_spacing() instead.
 
 
 <!-- ##### FUNCTION gtk_button_box_get_layout ##### -->
@@ -133,8 +134,11 @@ Gets the default number of pixels that pad the buttons in a given button box.
 @widget: a #GtkButtonBox.
 @ipad_x: the horizontal padding used by buttons in @widget.
 @ipad_y: the vertical padding used by buttons in @widget.
-@Deprecated: Use the style properties
-<literal>"child-internal-pad-x/-y"</literal> instead.
+@Deprecated: Use the style properties 
+  "<link linkend="GtkButtonBox--s-child-internal-pad-x">child-internal-pad-x</link>"
+  and
+  "<link linkend="GtkButtonBox--s-child-internal-pad-y">child-internal-pad-y</link>"
+  instead.
 
 
 <!-- ##### FUNCTION gtk_button_box_get_child_secondary ##### -->
@@ -152,8 +156,9 @@ Gets the default number of pixels that pad the buttons in a given button box.
 Sets the amount of spacing between buttons in a given button box.
 </para>
 
-@b: a #GtkButtonBox.
-@s: the number of pixels of spacing.
+@b: a #GtkButtonBox
+@s: the number of pixels of spacing
+@Deprecated: Use gtk_box_set_spacing() instead.
 
 
 <!-- ##### FUNCTION gtk_button_box_set_layout ##### -->
@@ -170,11 +175,14 @@ Changes the way buttons are arranged in their container.
 Sets a new default size for the children of a given button box.
 </para>
 
-@widget: a #GtkButtonBox.
-@min_width: a default width for buttons in @widget.
-@min_height: a default height for buttons in @widget.
+@widget: a #GtkButtonBox
+@min_width: a default width for buttons in @widget
+@min_height: a default height for buttons in @widget
 @Deprecated: Use the style properties
-<literal>"child-min-width/-height"</literal> instead.
+  "<link linkend="GtkButtonBox--s-child-min-width">child-min-width</link>"
+  and
+  "<link linkend="GtkButtonBox--s-child-min-height">child-min-height</link>"
+  instead.
 
 
 <!-- ##### FUNCTION gtk_button_box_set_child_ipadding ##### -->
-- 
2.30.2